home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / packet / p_g8bpq / bpq_misc / bpqyapp.doc < prev    next >
Encoding:
Text File  |  1991-08-15  |  28.1 KB  |  977 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                  BPQ Yapp File Server Program For IBM-PC/Clones
  9.                  ==============================================
  10.  
  11.  
  12.  
  13.                      Copyright Jon Welch - Ver 1.00 04/07/91
  14.                      ---------------------------------------
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                   Introduction
  26.                                   ============
  27.  
  28.              The BPQ Yapp File Server program is a software package which
  29.         provides a file server on a BPQ Node to enable users to upload or
  30.         download files from it using the YAPP file transfer protocol.  26
  31.         different  file  areas can be defined with access  restricted  to
  32.         upload  only,  download  only  or full  access.  Help  files  are
  33.         available  on  all commands plus an extra info  file  for  system
  34.         details.   The  system  name  and  command  prompts   are   fully
  35.         configurable by the user.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                              DISCLAIMER OF WARRANTY
  52.  
  53.         THIS  SOFTWARE  AND  MANUAL  ARE PROVIDED  "AS  IS"  AND  WITHOUT
  54.         WARRANTIES  AS  TO PERFORMANCE OF MERCHANTABILITY  OR  ANY  OTHER
  55.         WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE  VARIOUS
  56.         HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE
  57.         PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.
  58.  
  59.  
  60.  
  61.  
  62.         BPQYAPP V 1.00                  1                        04/07/91
  63.  
  64.  
  65.  
  66.  
  67.                                  C O N T E N T S
  68.                                  ===============
  69.  
  70.  
  71.              Chapter                                           Page
  72.              -------                                           ----
  73.  
  74.  
  75.                 1 System Requirements                            3
  76.                 2 Installing The Software                        4
  77.                   2.1 System Files and Usage                     4
  78.                 3 Configuring The Software                       5
  79.                 4 Setting up the Yapp File Server                7
  80.                 5 Using the Yapp File Server                     8
  81.  
  82.  
  83.              Appendices
  84.              ----------
  85.  
  86.  
  87.                 A - My BPQCFG.TXT File                          10
  88.                 B - Recognised Users                            16
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.                             Distribution Restrictions
  96.                             =========================
  97.  
  98.  
  99.              The  BPQ  Yapp  File Server program  is  NOT  public  domain
  100.         software  but  I am making no charge for you to use  it.  If  you
  101.         wish, you can make a contribution to the development of this  and
  102.         future  amateur radio software which I am currently  writing  but
  103.         feel under no obligation to do so.
  104.  
  105.              If you want to contribute or just contact me with  comments,
  106.         asking for help and advice etc. please write to :
  107.  
  108.  
  109.                                  Jon Welch,
  110.                                  50 Quarrydale Road,
  111.                                  Sutton In Ashfield,
  112.                                  Notts. NG17 4DR.
  113.                                  Great Britain
  114.  
  115.  
  116.              If  you  are  writing from  outside  Great  Britain,  please
  117.         remember to include your country in your address so I know  where
  118.         to reply to if necessary !
  119.  
  120.  
  121.  
  122.  
  123.  
  124.         BPQYAPP V 1.00                  2                        04/07/91
  125.  
  126.  
  127.  
  128.  
  129.         1 System Requirements
  130.         =====================
  131.  
  132.              The software is designed to run in conjunction with the  BPQ
  133.         Node  software  and  Deskview and as such, will  not  work  as  a
  134.         standalone YAPP File Server package.
  135.  
  136.              The software will work on any 80x86 computer running  MS-DOS
  137.         3.00  or  above  with  a  window  size  of  at  least  36K  under
  138.         Deskview.
  139.  
  140.              The software has been tested on BPQ V 4.01 and Deskview 2.31
  141.         but should work with any compatible version.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.         BPQYAPP V 1.00                  3                        04/07/91
  187.  
  188.  
  189.  
  190.  
  191.         2 Installing The Software
  192.         =========================
  193.  
  194.              To install the software you will need to copy all the  files
  195.         from  the  distribution file to a directory on a floppy  disc  or
  196.         your hard disc.
  197.  
  198.              You will also need to modify your current BPQCFG.TXT file to
  199.         add the yapp file server as an application into the node. This is
  200.         done  my  modify  the  applications line in  the  file  and  also
  201.         creating a port definition for the program. See the example of my
  202.         current BPQCFG.TXT file in Appendix E for help on doing this.
  203.  
  204.              In   more  detail,  you  need  to  add  a  keyword  to   the
  205.         applications  line which the user will enter to access  the  Yapp
  206.         File Server. There is room for eight on the applications line  so
  207.         find a spare slot and add it in. Each of the keywords is numbered
  208.         starting  at $01, then going up to $02, $04, $08, $10,  $20,  $40
  209.         and $80 for the other seven. In my example below, my YAPP keyword
  210.         is  the fifth in the line and so it's number or APPLMASK is  $10.
  211.         This  needs  to  be defined in the  port  configuration  for  the
  212.         program as shown below also.
  213.  
  214.         TNCPORT                       APPLICATIONS=PMS,,*SYS,MH,YAPP
  215.                 COM=3
  216.                 TYPE=TNC2
  217.                 APPLMASK=$10
  218.                 APPLFLAGS=$00
  219.         ENDPORT
  220.  
  221.              Please  refer  to the relevant documention that  comes  with
  222.         your copy of the BPQ software for more information if required.
  223.  
  224.              You  will also need to create a DVP file for Deskview and  a
  225.         sample one is enclosed for you to work from.
  226.  
  227.  
  228.         2.1 System Files and Usage
  229.         --------------------------
  230.  
  231.              The files comprising the system, where they are located  and
  232.         their function are as follows :
  233.  
  234.  
  235.         BPQYAPP.CFG - Configuration file for program (mandatory)
  236.         BPQYAPP.HLP - Text file sent for H command   (optional)
  237.         BPQYAPP.INF - Text file sent for I command   (optional)
  238.         BPQYAPP.EXE - Main Program
  239.         YS-PIF.DVP  - Sample configuration file for Deskview
  240.         BPQCFG.TXT  - My BPQ configuration file
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.         BPQYAPP V 1.00                  4                        04/07/91
  249.  
  250.  
  251.  
  252.  
  253.         3 Configuring The Software
  254.         ==========================
  255.  
  256.              The configuration for the program is stored in a single file
  257.         called BPQYAPP.CFG. This file is a standard text file and  should
  258.         be  edited  with  a  text editor that  does  not  add  formatting
  259.         characters to the text (such as Wordstar in non-document mode).
  260.  
  261.              The format of the file is given below :
  262.  
  263.              Line 1
  264.              ------
  265.  
  266.              This  tells the computer which virtual COM port your TNC  is
  267.         connected to in the BPQ Node software. It can either be from 1 to
  268.         16  depending  how you BPQCFG.TXT is configured.
  269.  
  270.              Line 2
  271.              ------
  272.  
  273.              This tells the computer which application number the program
  274.         is  based on it's position in the BPQCFG.TXT  applications  line.
  275.         For each of the available positions 1 to 8, this number will be :
  276.  
  277.                           1, 2, 4, 8, 16, 32, 64 or 128
  278.  
  279.              Line 3
  280.              ------
  281.  
  282.              This  line  is the name you wish to give to your  Yapp  File
  283.         Server.  This  is  displayed on the welcome screen  when  a  user
  284.         connects to your file server.
  285.  
  286.                   eg.      Jon's Megga Fabbo Yapp File Server
  287.  
  288.  
  289.              The  following lines identify the file upload  and  download
  290.         areas  you  wish to set up. Each line comprises of  five  fields,
  291.         each separated by a comma.
  292.  
  293.              Field 1 - File Area Designator. This is a single letter from
  294.         A  to Z which uniquely identifies the area. You need not  specify
  295.         the areas in alphabetical order.
  296.  
  297.              Field 2 - File Area Directory. This is the complete pathname
  298.         (including  drive if necessary) of the directory  containing  the
  299.         files for this area.
  300.  
  301.              Field 3 - File Area Description. This text string is used on
  302.         the  W command to tell the user what type of files are  contained
  303.         in the file area.
  304.  
  305.              Field  4  - Download Flag. This can be either a Y or  N  and
  306.         tells the system if file downloads are allowed from this area.
  307.  
  308.  
  309.  
  310.         BPQYAPP V 1.00                  5                        04/07/91
  311.  
  312.  
  313.  
  314.  
  315.              Field 5 - Upload Flag. This can be either a Y or N and tells
  316.         the system if file uploads are allowed to this area.
  317.  
  318.                   eg.  A,C:\TNC\PMS\DOWNLOAD,Download Area,Y,N
  319.  
  320.              You must terminate the list of file areas with a single line
  321.         containing a '*'.
  322.  
  323.              The final line in the configuration file is the prompt  sent
  324.         to the user.
  325.  
  326.                           eg.        Cmd:B,D,H,I,U,V,W >
  327.  
  328.  
  329.              A sample BPQYAPP.CFG file is thus :
  330.  
  331.         3
  332.         16
  333.         Jon's BPQ Yapp Server
  334.         A,C:\TNC\PMS\DOWNLOAD\GENERAL,General Download Area,Y,N
  335.         C,E:\GRPHCGA,CD-ROM CGA Graphic Programs     89 files,Y,N
  336.         E,E:\GRPHEGA,CD-ROM EGA/VGA Graphic Programs 94 files,Y,N
  337.         G,E:\GRPHUTIL,CD-ROM General Graphic Programs 47 files,Y,N
  338.         H,E:\GAMEADVE,CD-ROM Adventure Games         143 files,Y,N
  339.         I,E:\GAMEARCA,CD-ROM Arcade Games            270 files,Y,N
  340.         J,E:\GIFS,CD-ROM GIF Pictures            336 files,Y,N
  341.         T,C:\TNC\PMS\DOWNLOAD\TNC,TNC Driver Support Files,Y,N
  342.         U,C:\TNC\PMS\UPLOAD,Upload Area,N,Y
  343.         V,E:\VIRUSERS,CD-ROM Virus Protection Programs,Y,N
  344.         *
  345.         Cmd:B,D,H,I,U,V,W >
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.         BPQYAPP V 1.00                  6                        04/07/91
  373.  
  374.  
  375.  
  376.  
  377.         3.1 Setting up the Yapp File Server
  378.         -----------------------------------
  379.  
  380.              There  is  very  little to do in setting up  the  Yapp  File
  381.         Server.
  382.  
  383.              If  you have not done so already, configure the  BPQYAPP.CFG
  384.         file accordingly.
  385.  
  386.              You   may  also  want  to  customise  the  main  help   file
  387.         BPQYAPP.HLP and the info file BPQYAPP.INF
  388.  
  389.              For  all  your file areas, you can also create  an  optional
  390.         'area information' file. Again, this is a plain ASCII text  file,
  391.         must  be  called AREA.INF and stored in any file  area  that  you
  392.         require. When the user issues a 'W <area>' command, the  AREA.INF
  393.         file is also displayed below the header line and before the  list
  394.         of  file  names. This feature can be used to tell the  user,  for
  395.         example,  that all files in the area are .ZIP files and  must  be
  396.         decompressed with PKUNZIP before use.
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.         BPQYAPP V 1.00                  7                        04/07/91
  435.  
  436.  
  437.  
  438.  
  439.         3.2 Using The Yapp File Server
  440.         ------------------------------
  441.  
  442.              Assuming  you have installed the software correctly,  loaded
  443.         the  BPQ code, Deskview, a suitable terminal driver  program  and
  444.         opened  up the Yapp File Server program, the Yapp File Server  is
  445.         accessed  by  connecting to the node and typing the  keyword  you
  446.         defined in the BPQCFG.TXT applications line.
  447.  
  448.              You  will then be welcomed to the file server and  be  given
  449.         the command prompt.
  450.  
  451.              All  the time a remote user is logged onto the file  server,
  452.         the  sysop still has control over the keyboard in the  window  as
  453.         well. This means that the sysop can enter commands as though they
  454.         were  coming from the remote user. This can be used to guide  new
  455.         users through the program by showing them what commands do  what,
  456.         or  the  remote user can be logged off if he  mis-uses  the  file
  457.         server etc.
  458.  
  459.              To  close down the file server, simple use the close  option
  460.         of Deskview or press Alt X whilst in the file server window.
  461.  
  462.              The  different commands available whilst in the file  server
  463.         are :
  464.  
  465.  
  466.          B - Log off the Yapp File Server.
  467.  
  468.              Disconnecting  has  the same effect. The program  will  then
  469.         revert back to waiting for the next user to connect.
  470.  
  471.          D <area> <file> - Download file.
  472.  
  473.              This  is  used to download a file using YAPP  transfer.  The
  474.         area  can  be A to Z if setup in the configuration  file  by  the
  475.         sysop.
  476.  
  477.                 eg. D B HELP.COM
  478.  
  479.          H - Display help file.
  480.  
  481.              This  command will display the BPQYAPP.HLP file to the  user
  482.         if one exists.
  483.  
  484.          I - Display info file.
  485.  
  486.              This  command  will  display the  BPQYAPP.INF  file  if  one
  487.         exists.   Use   it  to  show  your   stations   hardware/software
  488.         configuration and anything else you may wish to tell the user.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.         BPQYAPP V 1.00                  8                        04/07/91
  497.  
  498.  
  499.  
  500.  
  501.          U <area> <file> - Upload file.
  502.  
  503.              This is used to upload a file using YAPP transfer. The  area
  504.         can be A to Z if setup in the configuration file by the sysop.
  505.  
  506.                 eg. U A MYPROG.EXE
  507.  
  508.          V - Show version.
  509.  
  510.              This  will  show  what version of the Yapp  File  Server  is
  511.         running.
  512.  
  513.          W - List file areas.
  514.  
  515.              This will list the file areas as configured by the sysop  in
  516.         the  BPQYAPP.CFG  file. Each area will indicate whether  you  can
  517.         download and upload to it.
  518.  
  519.          W <area> (filespec) - List files (matching filespec).
  520.  
  521.            This  will list all the files matching the  optional  filespec
  522.         (defaulting to all files) contained in that particular area.  The
  523.         area can be A to Z if setup by the sysop.
  524.  
  525.                 eg. W A *.ZIP
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.         BPQYAPP V 1.00                  9                        04/07/91
  559.  
  560.  
  561.  
  562.  
  563.         Appendix A - My BPQCFG.TXT File
  564.         ==========   ------------------
  565.  
  566.         ; For Version 3.59
  567.         ;
  568.         ;
  569.         ; CONFIGURATION FILE FOR G8BPQ SWITCH SOFTWARE
  570.         ;
  571.         ; The program which converts this text file to binary
  572.         ; form is currently very crude - be VERY careful when
  573.         ; editing this file!
  574.         ;
  575.         ;
  576.         ; The order of parameters in not important, but they
  577.         ; all must be specified - there are no defaults
  578.         ;
  579.         ;
  580.         ;
  581.         ; Memory Usage. If EMS=1, the system will attempt to put its
  582.         ; data area into EMS Memory. At the moment it makes no attempt
  583.         ; to manage sharing of the EMS window, so you must not run any
  584.         ; other software using EMS.
  585.         ;
  586.         ; It seems to work ok when used with Desqview, at least on my
  587.         ; AST, but it is primarily intended for use with AA4RE BBS, which
  588.         ; needs a great deal of space.
  589.         ;
  590.         ;
  591.         EMS=0                           ; dont use EMS RAM
  592.         ;
  593.         ; I seem to have problems with systems not using DESQVIEW -
  594.         ; especially NNA BBS's. The DV calls SHOULD be ignored if DV is
  595.         ; not loaded, but just in case, if you set DESQVIEW=0, the
  596.         ; 'Release Timeslice' call wont be used. MAKE SURE that you set
  597.         ; DESQVIEW=1 if using DV, or performance will be seriously
  598.         ; affected.
  599.         ;
  600.         DESQVIEW=1
  601.         ;
  602.         ;
  603.         ; Station Identification.
  604.         ;
  605.         ; If a user connects to the NODE Callsign or Alias, he is linked
  606.         ; to the switch code, and can use normal NetRom/TheNet commands
  607.         ;
  608.         ; If he connects to the BBS Callsign or Alias he will be connected
  609.         ; directly to a BBS port. If none are available, the connect will
  610.         ; be rejected.
  611.         ;
  612.         ; Note that of you are running only a NODE (ie BBS=0), or
  613.         ; or just a BBS (NODE=0), then you must still put in two pairs of
  614.         ; calls, but they MUST be the SAME.
  615.         ;
  616.         ; If you are running both, the calls MUST be different
  617.  
  618.  
  619.  
  620.         BPQYAPP V 1.00                  10                        04/07/91
  621.  
  622.  
  623.  
  624.  
  625.         NODECALL=G7JJF-8                ; NODE CALLSIGN
  626.         NODEALIAS=IP0423
  627.  
  628.  
  629.         BBSCALL=G7JJF                   ; BBS CALLSIGN
  630.         BBSALIAS=JJFPMS                 ; BBS ALIAS
  631.  
  632.         ;
  633.         ; 'ID' MESSAGE - SENT EVERY IDINTERVAL MINS
  634.         ;
  635.         ; WILL BE ADDRESSED FROM THE PORT CALLSIGN (IF DEFINED)
  636.         ;      ELSE FROM THE NODE CALL
  637.         ;
  638.         ; The following format allows KA nodes to include your system in
  639.         ; their 'Nodes' lists.
  640.         ;
  641.         IDMSG:
  642.         Network node (IP0423) running TNCBPQ V1.40 and BPQ Yapp Server V1.00
  643.         ***
  644.         ;
  645.         UNPROTO=MAIL                         ; DEFAULT UNPROTO ADDR
  646.  
  647.         ; 'I' COMMAND TEXT
  648.         ;
  649.         ; Note that the bit about needing a port param in connects is only
  650.         ; necessary if you are running more that one (radio) port.
  651.         ;
  652.         INFOMSG:
  653.         G7JJF Packet Switch, Sutton In Ashfield, Notts. IO93IC
  654.         Commands are basically the same as NET/ROM, but to connect to
  655.         another normal station (not another node), you must specify a
  656.         port number before the callsign. Use PORTS command to list
  657.         available ports. The PMS command connects you to the associated
  658.         Mailbox and the YAPP command takes you to a Yapp File Server
  659.         for downloading/uploading of files.
  660.         ***
  661.         ; CTEXT - If specified, will be sent when someone connects to
  662.         ; the NODE ALIAS at level 2. It is not sent on connects to the
  663.         ; NODE callsign, as this could confuse BBS forwarding connect
  664.         ; scripts.
  665.         ;
  666.         CTEXT:
  667.         Welcome to G7JJF's Packet Switch in Sutton In Ashfield
  668.         Type ? for list of available commands.
  669.         ***
  670.  
  671.  
  672.         ;       Network System Parameters
  673.         ;
  674.         OBSINIT=5               ; INITIAL OBSOLESCENCE VALUE
  675.         OBSMIN=4                ; MINIMUM TO BROADCAST
  676.         NODESINTERVAL=60        ; 'NODES' INTERVAL IN MINS
  677.         IDINTERVAL=15           ; 'ID' BROADCAST INTERVAL (UK Regs require
  678.                                 ; an AX25 ID every 15 mins)
  679.         ;
  680.  
  681.  
  682.         BPQYAPP V 1.00                  11                        04/07/91
  683.  
  684.  
  685.  
  686.  
  687.         BTINTERVAL=15           ; NO BEACONS
  688.         L3TIMETOLIVE=25         ; MAX L3 HOPS
  689.         L4RETRIES=3             ; LEVEL 4 RETRY COUNT
  690.         ;
  691.         ; I have seen suggestions that L4TIMEOUT should be increased to very
  692.         ; high values (even as long as seven mins). Although 60 may be a bit
  693.         ; short in some cases, I STRONGLY advise that you dont go much above
  694.         ; 120 secs unless you understand ALL the implications.
  695.         ;
  696.         ; I've set TTL and TIMEOUT to the values agreed by the latest SYSOPS
  697.         ; meeting - this does not imply that I agree with them!
  698.         ;
  699.         L4TIMEOUT=120           ; LEVEL 4 TIMEOUT
  700.         L4DELAY=10              ; LEVEL 4 DELAYED ACK TIMER
  701.         L4WINDOW=4              ; DEFAULT LEVEL 4 WINDOW
  702.         ;
  703.         MAXLINKS=30             ; MAX LEVEL 2 LINKS (UP,DOWN AND INTERNODE)
  704.         MAXNODES=120            ; MAX NODES IN SYSTEM
  705.         MAXROUTES=35            ; MAX ADJACENT NODES
  706.         MAXCIRCUITS=64          ; NUMBER OF L4 CIRCUITS
  707.         minqual=10              ; MINIMUM QUALITY TO ADD TO NODES TABLE
  708.  
  709.         BBSQUAL=250             ; BBS Quality relative to NODE - used to
  710.                                 ; limit 'spread' of BBS through the
  711.                                 ; network to your required service area.
  712.                                 ; I've been asked to set a low default to
  713.                                 ; encourage you to think about a suitable
  714.                                 ; value. Max is 255
  715.  
  716.         BUFFERS=255             ; PACKET BUFFERS - 255 MEANS ALLOCATE AS MANY
  717.                                 ; AS POSSIBLE - NORMALLY ABOUT 130,
  718.                                 ; DEPENDING  ON OTHER TABLE SIZES
  719.         ;
  720.         ;       TNC DEFAULT PARAMS
  721.         ;
  722.         PACLEN=128                      ; MAX PACKET SIZE
  723.         ;
  724.         ; PACLEN is a problem! The ideal size depends on the link(s) over
  725.         ; which a packet will be sent. For a session involving another node,
  726.         ; we have no idea what is at the far end. Ideally each node should have
  727.         ; the capability to combine and then refragment messages to suit each
  728.         ; link segment - maybe when there are more of my nodes about than 'real'
  729.         ; ones, i'll do it. When the node is accessed directly, things are a
  730.         ; bit easier, as we know at least something about the link. So, from
  731.         ; Version 3.11 onwards, there are two PACLEN params, one here and
  732.         ; one in the PORTS section. This one is used to set the initial value
  733.         ; for sessions via other nodes, and for sessions initiated from here.
  734.         ; The other is used for incoming direct (Level 2)       sessions.
  735.         ; In all cases the TNC PACLEN command can be used to override
  736.         ; the defaults.
  737.         ;
  738.         ; The main reason for changing this now was a request from someone
  739.         ; wanting to run an HF port.
  740.         ;
  741.         ;
  742.  
  743.  
  744.         BPQYAPP V 1.00                  12                        04/07/91
  745.  
  746.  
  747.  
  748.  
  749.         ;
  750.         TRANSDELAY=1            ; TRANSPARENT MODE SEND DELAY - 1 SEC
  751.         ;
  752.         ;       Level 2 Parameters
  753.         ;
  754.         ; T1, T2 and N2 are now int the PORTS section
  755.         ;
  756.         T3=180                  ; LINK VALIDATION TIMER (3 MINS)
  757.  
  758.         IDLETIME=900            ; IDLE LINK SHUTDOWN TIMER (15 MINS)
  759.         ;
  760.         ;
  761.         ;       Configuration Options
  762.         ;
  763.         BBS=1                   ; INCLUDE BBS SUPPORT
  764.         NODE=1                  ; INCLUDE SWITCH SUPPORT
  765.         ;
  766.         HIDENODES=0             ; IF SET TO 1, NODES STARTING WITH # WILL
  767.                                 ; ONLY BE DISPLAYED BY A NODES * COMMAND
  768.         ;
  769.         ;
  770.         ;
  771.         ;       'COMBIOS' Port definitions.
  772.         ;
  773.         ;       This section defines the virtual TNC's that the code supports.
  774.         ;
  775.         ;       I'm afraid this is now rather more complicated than it was!
  776.         ;
  777.         ;       You can now define any COMBIOS port to run in normal (TNC2)
  778.         ;       mode, PK232 HOSTMODE (with varients for UFQ and AA4RE), or KISS
  779.         ;       mode. KISS mode allows you to run things like TCP/IP, STATS
  780.         ;       packages, PACSAT Telemetry decode, etc above the switch.
  781.         ;
  782.         ;       The basic format is:
  783.         ;
  784.         ;           TNCPORT
  785.         ;               COM=n           ; COMBIOS port number
  786.         ;               TYPE=TNC2|KISS|PK232/AA4RE|PK232/UFQ
  787.         ;               KISSMASK=nn     ; Required only for KISS
  788.         ;               APPLMASK=nn     ; Defaults to 1 (BBS)
  789.         ;           ENDPORT
  790.         ;
  791.         ;       TYPE defaults to TNC2. See file KISSMODE.DOC for full details
  792.         ;       of facilities available in KISS mode.
  793.         ;
  794.         ;       The two PK232 modes are equvalent to the old HOSTMODE=1 or 2,
  795.         ;       but can now be used on any port. See HOSTMODE.DOC for more
  796.         ;       details
  797.         ;       Dont try to define more than 16 ports.
  798.         ;
  799.         ;       For my software, you must decide on the port for the PMS to be
  800.         ;       accessed from. This can be anything from 1 to 15.
  801.         ;       You must then set this port, plus the following to the settings
  802.         ;       shown below :
  803.  
  804.  
  805.  
  806.         BPQYAPP V 1.00                  13                        04/07/91
  807.  
  808.  
  809.  
  810.  
  811.         TNCPORT
  812.                 COM=1
  813.                 TYPE=TNC2
  814.                 APPLMASK=$03
  815.                 APPLFLAGS=$07
  816.         ENDPORT
  817.  
  818.         TNCPORT
  819.                 COM=2
  820.                 TYPE=TNC2
  821.                 APPLMASK=$08
  822.                 APPLFLAGS=$00
  823.         ENDPORT
  824.  
  825.         ;       This is the setting for my BPQ Yapp File Server if you
  826.         ;       want to install it eventually.
  827.  
  828.         TNCPORT
  829.                 COM=3
  830.                 TYPE=TNC2
  831.                 APPLMASK=$10
  832.                 APPLFLAGS=$00
  833.         ENDPORT
  834.  
  835.         PORT
  836.         ;       ID=144.625 Mhz 1200 baud
  837.                 ID=Not Active
  838.                 TYPE=ASYNC
  839.                 PROTOCOL=KISS
  840.                 IOADDR=2F8H                     ; COM1 - FOR COM2 PUT 2F8H
  841.                 INTLEVEL=3                      ; COM1 - FOR COM2 PUT 3
  842.                 SPEED=9600
  843.                 CHANNEL=A
  844.                 QUALITY=10
  845.                 MAXFRAME=2
  846.                 TXDELAY=500
  847.                 SLOTTIME=100
  848.                 PERSIST=64
  849.                 FULLDUP=0
  850.                 FRACK=7000
  851.                 RESPTIME=2000
  852.                 RETRIES=10
  853.                 PACLEN=120
  854.  
  855.         ENDPORT
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.         BPQYAPP V 1.00                  14                        04/07/91
  869.  
  870.  
  871.  
  872.  
  873.         ;
  874.         ;       2ND PORT OF KPC4/KAM (FIRST PORT IS DEFINED AS ABOVE)
  875.         ;
  876.         PORT
  877.         ;       ID=432.675 Mhz 1200 baud
  878.                 ID=144.625 Mhz 1200 baud
  879.                 TYPE=ASYNC
  880.                 PROTOCOL=KISS
  881.                 IOADDR=2F8H
  882.                 INTLEVEL=3
  883.                 SPEED=9600
  884.                 CHANNEL=B       ; this is the special bit for KAM/KPC4
  885.                 QUALITY=10
  886.                 MAXFRAME=2
  887.                 TXDELAY=500
  888.                 SLOTTIME=100
  889.                 PERSIST=64
  890.                 FULLDUP=0
  891.                 FRACK=7000
  892.                 RESPTIME=2000
  893.                 RETRIES=10
  894.                 PACLEN=120
  895.  
  896.         ENDPORT
  897.  
  898.         ROUTES:
  899.         ;
  900.         ;       ROUTES TO LOCK IN
  901.         ;
  902.         ;       specify Callsign, Quality and Port. You can now also specify
  903.         ;       MAXFRAME, FRACK, PACLEN (in that order) to override the port
  904.         ;       defaults.
  905.         ;
  906.         ;
  907.         ***
  908.         ;
  909.         ;       APPLICATIONS SUPPORTED
  910.         ;
  911.         ;       UP TO 8 ENTRIES OF UP TO 12 BYTES EACH
  912.         ;
  913.         ;       THE FIRST 3 ARE RESERVED FOR BBS, HOST, AND REMOTE SYSOP
  914.         ;       YOU CAN DEFINE THE OTHERS AS YOU LIKE.
  915.         ;
  916.         ;       FOR COMPATIBILITY WITH EARLIER VERSIONS, JUST ENTER
  917.         ;       APPLICATIONS=BBS
  918.         ;
  919.         ;       NAMES STARTING WITH * ARE NOT INCLUDED IN 'VALID COMMANDS'
  920.         ;       DISPALY
  921.         ;
  922.         APPLICATIONS=PMS,,*SYS,MH,YAPP
  923.         ;
  924.         ;
  925.  
  926.  
  927.  
  928.  
  929.  
  930.         BPQYAPP V 1.00                  15                        04/07/91
  931.  
  932.  
  933.  
  934.  
  935.         Appendix B - Recognised Users
  936.         ==========   ----------------
  937.  
  938.  
  939.  
  940.              Jon      G7JJF
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.              If  you have any problems using the software, first  of  all
  953.         please  read this manual thoroughly. The answer to most  of  your
  954.         questions  will  be hidden somewhere. If all else  fails,  please
  955.         contact me at the address given below or G7JJF @ GB7FLG for  help
  956.         and advice.
  957.  
  958.  
  959.              I  would  also appreciate any input you would care  to  give
  960.         concerning  the program.  If you have any ideas or comments  that
  961.         would make it a better program, then please let me know.
  962.  
  963.  
  964.  
  965.  
  966.               *****************************************************
  967.               **** Remember To Support Your Local Packet Group ****
  968.               *****************************************************
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.         Jon Welch,                 G7JJF @ GB7FLG.#23.GBR.EU
  976.         50 Quarrydale Road,        CompuServe ID : 100012,2607
  977.         Sutton In Ashfield,
  978.         Notts. NG17 4DR.
  979.         Great Britain
  980.  
  981.         4th July, 1991
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.         BPQYAPP V 1.00                  16                        04/07/91
  993.  
  994.  
  995.